home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / cap_envl.z / cap_envl
Encoding:
Text File  |  2002-10-03  |  4.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCAAAAPPPP____EEEENNNNVVVVLLLL((((3333CCCC))))                                                      CCCCAAAAPPPP____EEEENNNNVVVVLLLL((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cap_envl, cap_envp - ensure sufficient process privilege
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ccccaaaappppaaaabbbbiiiilllliiiittttyyyy....hhhh>>>>
  13.  
  14.      iiiinnnntttt ccccaaaapppp____eeeennnnvvvvllll((((iiiinnnntttt ffffllllaaaaggggssss,,,, ............ ////**** ccccaaaapppp____vvvvaaaalllluuuueeee____tttt ****////))))
  15.  
  16.      iiiinnnntttt ccccaaaapppp____eeeennnnvvvvpppp((((iiiinnnntttt ffffllllaaaaggggssss,,,, ssssiiiizzzzeeee____tttt nnnnccccaaaapppp,,,, ccccoooonnnnsssstttt ccccaaaapppp____vvvvaaaalllluuuueeee____tttt ****ccccaaaappppssss))))
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _c_a_p__e_n_v_l and _c_a_p__e_n_v_p ensure that the calling process will have
  20.      sufficient privilege to perform actions requiring the specified
  21.      capabilities. If the desired and current capability sets are different
  22.      and if the desired capability set can be obtained because the process has
  23.      the CAP_SETPCAP capability, then the capabilities in the desired will be
  24.      acquired.
  25.  
  26.      _c_a_p__e_n_v_l accepts a variable argument list of capability values,
  27.      terminated by an argument of 0 (or CCCCAAAAPPPP____NNNNOOOOTTTT____AAAA____CCCCIIIIDDDD).
  28.  
  29.      _c_a_p__e_n_v_p accepts a counted array of capability values, whose size is
  30.      specified by _n_c_a_p and whose address is _c_a_p_s.
  31.  
  32.      _c_a_p__e_n_v_l and _c_a_p__e_n_v_p also understand several _f_l_a_g_s, which may be
  33.      bitwise-ored together:
  34.  
  35.      CAP_ENV_SETUID  If successful, set the process' effective userid to its
  36.                      real userid.
  37.  
  38.      CAP_ENV_RECALC  If successful, set the CAP_FLAG_PURE_RECALC capability
  39.                      flag.
  40.  
  41.      _c_a_p__e_n_v_l and _c_a_p__e_n_v_p will return an error if they cannot give the
  42.      calling process privilege equivalent to having the capabilities specified
  43.      in _c_a_p_s, or if the optional actions specified by _f_l_a_g_s were not
  44.      successful.
  45.  
  46. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  47.      _c_a_p__e_n_v_l and _c_a_p__e_n_v_p return 0 if successful, or -1 on error.
  48.  
  49. EEEERRRRRRRROOOORRRRSSSS
  50.      _c_a_p__e_n_v_l:
  51.  
  52.      EINVAL          One of the specified capabilities is invalid.
  53.  
  54.      EPERM           The calling process has insufficient privilege to perform
  55.                      privileged actions requiring the requested capabilities.
  56.  
  57.      _c_a_p__e_n_v_p:
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCAAAAPPPP____EEEENNNNVVVVLLLL((((3333CCCC))))                                                      CCCCAAAAPPPP____EEEENNNNVVVVLLLL((((3333CCCC))))
  71.  
  72.  
  73.  
  74.      EINVAL          _n_c_a_p is 0, _c_a_p_s is _NNNN_UUUU_LLLL_LLLL, or one of the specified
  75.                      capabilities is invalid.
  76.  
  77.      EPERM           The calling process has insufficient privilege to perform
  78.                      privileged actions requiring the requested capabilities.
  79.  
  80. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  81.      cap_set_proc(3c), capabilities(4).
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.